Apex (Beta)

Die Apex-Unterstützung in Marked ist in der Beta-Phase. Das Verhalten kann sich ändern, während die Integration reift. Probleme, unerwartete Darstellung oder fehlende Syntax melden Sie bitte unter support.markedapp.com.

Apex ist ein vereinheitlichter Markdown-Prozessor: eine einzige Engine, die die Funktionen abdecken will, für die man sonst CommonMark, GitHub Flavored Markdown (GFM), MultiMarkdown oder Kramdown wählt – ohne die jeweils anderen Varianten aufzugeben.

In Marked läuft Apex (Beta) immer im vereinheitlichten Modus von Apex (alle diese Funktionsfamilien gleichzeitig aktiv). Einen eigenen „CommonMark-Modus“ oder „Kramdown-Modus“ von Apex wählen Sie in Marked noch nicht; das kann später kommen.

Im Markdown-Dingus können Sie mit Apex experimentieren. Eine kompakte Übersicht finden Sie unter Hilfe Markdown-Referenz im Reiter Apex.

Warum es Apex gibt

Die Markdown-„Varianten“ haben sich aus guten Gründen auseinanderentwickelt – GitHub brauchte Aufgabenlisten und Tabellen, MultiMarkdown Fußnoten und Metadaten, Kramdown Attributlisten –, doch wer sich für einen Prozessor entscheidet, verzichtet meist auf die Syntax eines anderen.

Apex will diese Erweiterungen zusammenführen, sodass ein einziges Dokument Folgendes nutzen kann:

  • gewohnte CommonMark-/GFM-Schreibweisen (abgegrenzter Code, Aufgabenlisten, Durchstreichung, GFM-Tabellen)
  • Fußnoten, Abkürzungen und Metadaten im MultiMarkdown-Stil
  • Kramdown-freundliche Definitionslisten, Mathematik und (für Fortgeschrittene) Attributlisten
  • auf Marked zugeschnittene Annehmlichkeiten wie Callouts, CriticMarkup und Inhaltsverzeichnis-Marker

Die vollständige Dokumentation des Projekts steht im Apex-Wiki. Diese Seite behandelt, was Sie im Alltag in Markeds Vorschau brauchen.

Apex in Marked aktivieren

  1. Öffnen Sie Marked Settings, Processor pane.
  2. Stellen Sie Markdown verarbeiten mit auf Apex (Beta).
  3. Oder legen Sie es pro Dokument über Metadaten fest, etwa Processor: apex (Aliasse: apex-beta, unified).

Die Aliasse funktionieren auch in AppleScript, in den Conductor-Aktionen „Prozessor ausführen“, in der Standardausgabe eines benutzerdefinierten Prozessors (APEX) und in x-marked://-URLs für Voreinstellungen.

In dieser Beta löst Marked seine eigenen Dateieinbindungen (<<[file] und verwandte Marked-Include-Pfade) weiterhin auf, bevor Apex läuft. Die native Include-Engine von Apex bleibt in Marked wegen der Sandbox ausgeschaltet. Nutzen Sie die Einbindungsfunktionen von Marked wie gewohnt.

Grundlegende Syntax, die Apex ergänzt oder vereinheitlicht

Standard-Markdown (Überschriften, Hervorhebung, Links, Bilder, Listen, Blockzitate, Code) funktioniert wie erwartet. Die folgenden Punkte sind die Extras, die beim Umstieg auf Apex am häufigsten gebraucht werden.

Aufgabenlisten 

- [ ] Todo
- [x] Done

Durchstreichung 

~~removed text~~

Tabellen

GFM-Pipe-Tabellen mit Trennzeile unter der Kopfzeile und Spaltenausrichtung: 

| Left | Center | Right |
| :--- | :----: | ----: |
| a    | b      | c     |

Erweiterte Tabellenfunktionen (Zeilenverbund ^^, Spaltenverbund, Beschriftungen, Gittertabellen, CSV) sind im Wiki beschrieben: Tables.

Fußnoten

Im Referenzstil: 

See the note[^1].

[^1]: Footnote text.

Die aus MultiMarkdown und Kramdown bekannten Inline-Schreibweisen werden ebenfalls unterstützt. Einzelheiten: Syntax.

Definitionslisten 

Apple
: A fruit.
: A computer company.

Hoch- und Tiefstellung 

Text^super^ and H~2~O

Mathematik

Inline $x^2$ und abgesetzt $$...$$ (die Darstellung in der Vorschau steuern weiterhin Markeds MathJax-/KaTeX-Einstellungen).

Callouts

Im Stil von Obsidian und Bear: 

> [!NOTE]
> Something worth highlighting.

Siehe auch Markeds Marked-Spezialsyntax und die Wiki-Seite Callouts von Apex.

CriticMarkup 

{++insertion++}
{--deletion--}
{==highlight==}
{>>comment<<}

Aktivieren Sie CriticMarkup in Marked wie gewohnt; Apex kann die Critic-Syntax in der Verarbeitungskette darstellen. Siehe CriticMarkup.

Abkürzungen 

The HTML spec is long.

Emoji-Kurzcodes 

Ship it :rocket:

Metadaten

YAML-Front-Matter, Kopfzeilen im MultiMarkdown-Stil (Key: Value) und Pandoc-Titelblöcke werden erkannt. Werte fügen Sie, wo unterstützt, mit [%key] ein.

Einzelheiten zur Konfiguration im Wiki: Configuration und Metadata Transforms.

Inhaltsverzeichnis-Marker

Apex versteht gängige Marker für Inhaltsverzeichnisse, darunter:

  • <!--TOC-->
  • {{TOC}} oder {{TOC:2-4}}
  • {:toc} im Kramdown-Stil

Eine Überschrift schließen Sie mit {:.no_toc} aus, wo IAL verfügbar ist. Mehr: Syntax.

Spezielle Marker

Auf Marked zugeschnittene HTML-Kommentare wie <!--BREAK--> (Seitenumbruch) und <!--PAUSE:N--> (Autoscroll) funktionieren auch in Apex-Vorschauen weiter.

Fortgeschrittene Themen (Wiki)

Für Funktionen, die mächtig, im Vorschau-Alltag aber seltener sind, nutzen Sie das Apex-Wiki:

Thema Wiki
Indexerstellung Indices
Zitate / Literaturverzeichnis Citations
Inline-Attributlisten, Spans, abgegrenzte Divs Inline Attribute Lists
Dokumente aus mehreren Dateien und Einbindungen Multi-File Documents
Formate für Überschriften-IDs Header IDs
Bilder in mehreren Formaten Multi-Format Images
Kompatibilitätsmodi (CLI) Modes
Plugins und Filter Plugins, Filters
Quarto / Pandoc / Jekyll Quarto Mode, Pandoc Integration, Jekyll

Siehe auch

Next up: Apex-Konfiguration ▶

Support Site | Legal | Privacy